home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / xtrdos.zip / XTRDOS.DOC < prev    next >
Text File  |  1992-12-29  |  77KB  |  2,067 lines
  1.  
  2. Filename: XTRDOS.DOC
  3. Products: Xtrieve PLUS v4.10 and v4.11a for DOS
  4.       XQLP v2.11a
  5.       XQLPO v2.11a
  6. Date:      December 1992
  7.  
  8.    This Readme document accompanies the DOS environment patches for Xtrieve
  9.    PLUS v4.10 and v4.11a programs and utilities, the DOS environment patches for
  10.    the XQLP v2.11a and XQLPO v2.11a programs, and the optional DOS environment
  11.    patches for the XQLP and XQLPO programs.
  12.  
  13.    NOTE:  In this document, XQLP and XQLPO are referred to collectively as
  14.       XQLP(O).
  15.  
  16.    This patch is cumulative and includes updates for both v4.10 and v4.11.  If
  17.    you have Xtrieve PLUS v4.10, read this entire document.  If you have Xtrieve
  18.    PLUS v4.11, read "Installation Procedure" and then skip to "Xtrieve PLUS
  19.    v4.11 for DOS."
  20.  
  21.  
  22. ================================================================================
  23. Disclaimer
  24. ==========
  25.  
  26.    Novell, Inc. makes no representations or warranties with respect to any
  27.    NetWare software, and specifically disclaims any express or implied
  28.    warranties of merchantability, title, or fitness for a particular
  29.    purpose.
  30.  
  31.    Distribution of any NetWare software is forbidden without the express
  32.    written consent of Novell, Inc.  Further, Novell reserves the right to
  33.    discontinue distribution of any NetWare software.
  34.  
  35.    Novell is not responsible for lost profits or revenue, loss of use of
  36.    the software, loss of data, costs of re-creating lost data, the cost of
  37.    any substitute equipment or program, or claims by any party other than
  38.    you.  Novell strongly recommends a backup be made before any software is
  39.    installed.  Technical support for this software may be provided at the
  40.    discretion of Novell.
  41.  
  42.    PATCH.EXE is a proprietary product of PocketSoft.  PATCH.EXE and Patch
  43.    Build generated files are distributed by Novell, Inc. under license from
  44.    PocketSoft.
  45.  
  46.    Direct Connect and NetWire are service marks of Novell, Inc.
  47.  
  48.    CompuServe is a registered trademark of CompuServe, Incorporated.
  49.  
  50.  
  51. ================================================================================
  52. Contents
  53. ========
  54.  
  55.    Installation Procedure
  56.    Patch File Information
  57.    Xtrieve PLUS v4.10 for DOS and XQLP(O) v2.11a
  58.       Original File Information
  59.       Xtrieve PLUS v4.10 Patch Set Descriptions
  60.       XQLP v2.11a and XQLPO v2.11a Patch Set Descriptions
  61.       XQLP(O) v2.11b Optional Patches
  62.    Xtrieve PLUS v4.11 for DOS
  63.       Original File Information
  64.       Xtrieve PLUS v4.11 Patch Set Descriptions
  65.    Documentation Updates
  66.    Online Help Updates
  67.  
  68.  
  69. ================================================================================
  70. Installation Procedure
  71. ======================
  72.  
  73.    The PATCHXTR.BAT and PATCH.EXE files mentioned in this procedure require
  74.    DOS v2.1 or later.
  75.  
  76.    The Xtrieve PLUS for DOS patch set contains the following:
  77.  
  78.    -  This Readme document
  79.    -  PATCH.EXE, a utility Novell provides for installing product patches
  80.    -  PATCHXTR.BAT, a batch file to facilitate patch installation
  81.    -  Patch files for Xtrieve PLUS (XTRIEVE.410 and XTRIEVE.411, which you can
  82.       use to patch versions 4.10 or 4.11) and for XQLP (XQLP.21A and XQLPO.21A)
  83.    -  Replacement files (files with the same names as the files they will
  84.       replace)
  85.  
  86.    To update Xtrieve PLUS, complete the following steps:
  87.  
  88.    1.  Create a directory on your system, and copy the XTRDOS.ZIP file to
  89.        that directory.
  90.  
  91.    2.  Use the utility PKUNZIP.EXE to unzip the zipped files.
  92.  
  93.    3.  Install the patch files as follows:
  94.  
  95.        a.  Refer to the list of patch files in the section "Original File
  96.        Information," find the original files on your system, and ensure that
  97.        your original files match those listed.
  98.  
  99.        NOTE:  Use the original file information specific to the version of
  100.           Xtrieve PLUS you are patching.
  101.  
  102.        b.  Use the DOS COPY command to copy the original file into the
  103.        directory that contains the unzipped patch files from XTRDOS.ZIP.
  104.  
  105.        c.  Run PATCHXTR and specify the parameter for the version of Xtrieve
  106.        PLUS you want to patch.  For example, to patch Xtrieve PLUS v4.10,
  107.        enter PATCHXTR 410.    (Entering PATCHXTR without any parameters
  108.        displays a usage screen that lists all the parameters.)
  109.  
  110.        PATCHXTR verifies that you are patching the original released version
  111.        of the software, applies the patch, and gives the original file an
  112.        .ORG extension.
  113.  
  114.        d.  Use the DOS COPY command to copy the patched file back to the
  115.        original file's directory.
  116.  
  117.    4.  Install the replacement files as follows:
  118.  
  119.        a.  Find the directory that contains the original files to be
  120.        replaced.
  121.  
  122.        b.  Before copying the replacement files, back up the original files
  123.        to a diskette or to another directory.
  124.  
  125.        c.  Use the COPY command to replace the original files with the
  126.        new files.
  127.  
  128.    5.  After applying the patches, you can remove the directory you created to
  129.        store the XTRDOS.ZIP file.  You may also want to verify the version
  130.        numbers when you load each program.  The version numbers should match
  131.        those listed in the next section, "Patch File Information."
  132.  
  133.    IMPORTANT:  If you patched v4.10, your current version of Xtrieve PLUS is
  134.            v4.11.  When you are ready to patch v4.11, perform Steps 4
  135.            through 6 again, using the information provided for Xtrieve PLUS
  136.            v4.11.
  137.  
  138.  
  139. ================================================================================
  140. Patch File Information
  141. ======================
  142.  
  143.    Patch Set Filename:    XTRDOS.ZIP
  144.  
  145.    Date:        12-29-92
  146.  
  147.    Files Included:    XTRDOS     DOC         This document
  148.             PATCH     EXE          76981   1-30-92    5:00a
  149.             PATCHXTR BAT           3928  12-17-92    3:55p
  150.             XQLOPT     ZIP          26582   9-22-92  12:08p
  151.  
  152.      (Patch files)    XTRDOS     410  v4.11  146529   9-18-92    2:42p
  153.             XTRDOS     411  v4.11b  69874  12-17-92  10:43a
  154.             XQLP     21A  v2.11b    270   9-21-92    1:54p
  155.             XQLPO     21A  v2.11b    269   9-21-92    1:55p
  156.  
  157.    (Replacement files)    MAKE_XTA EXE  v4.11b  68768  12-08-92    7:09p
  158.             XCFP     EXE  v4.11b  44624  12-08-92    7:30p
  159.             XMENU     EXE  v4.11b  98960  12-08-92    7:28p
  160.             XTRIEVE  MSG          39018  12-08-92    5:06p
  161.             XTRIEVE  HLP         221184   3-20-92    5:55p
  162.             XHFP     EXE  v4.11b  16672  12-08-92    7:29p
  163.             XTRIEVE  MEN  v4.11b  13347  12-08-92    5:06p
  164.  
  165.  
  166. ================================================================================
  167. Xtrieve PLUS v4.10 for DOS and XQLP(O) v2.11a
  168. =============================================
  169.  
  170.    The following information pertains to the DOS environment patches for
  171.    the Xtrieve PLUS v4.10 and XQLP(O) v2.11a programs and utilities.
  172.  
  173.  
  174. Original File Information
  175. -------------------------
  176.  
  177.    To ensure you are patching the original files, compare the files to be
  178.    patched with those in the following list.  This list shows the byte size and
  179.    the date and time stamps for the original release.
  180.  
  181.    Patch this file:
  182.             XTRIEVE  EXE  v4.10  454848   8-14-91  11:23a
  183.  
  184.    Replace these files:
  185.             XQLP     EXE  v2.11a 204752   8-18-91    1:34p
  186.             XQLPO     EXE  v2.11a 223936   8-18-91    1:40p
  187.             MAKE_XTA EXE  v4.10   65712   7-16-91    7:20p
  188.             XCFP     EXE  v4.10   44032   7-17-91    9:19a
  189.             XMENU     EXE  v4.10   98912   7-16-91    8:28p
  190.             XHFP     EXE  v4.10   16672   7-17-91    9:29a
  191.             XTRIEVE  MSG          38204   8-07-92    3:54p
  192.             XTRIEVE  HLP         211968   8-07-92    3:54p
  193.             XTRIEVE  MEN  v4.10   13325   8-07-92    3:54p
  194.  
  195.  
  196. Xtrieve PLUS v4.10 Patch Set Descriptions
  197. -----------------------------------------
  198.  
  199.    The following information pertains to the DOS environment patches for
  200.    the Xtrieve PLUS v4.10 program.  This section describes each patch in the
  201.    patch set.
  202.  
  203.    For each patch, the description includes one or more search strings.  These
  204.    search strings indicate areas in which you may encounter the problem that the
  205.    patch addresses.  The search strings may help you quickly determine whether
  206.    the patch you need for a specific problem is included in this patch set.
  207.  
  208.    NOTE:  In some cases, the text describes a problem or reported bug that the
  209.       update does NOT fix.    In those cases, use the workaround provided.
  210.  
  211.    * * * * * * * * *
  212.  
  213.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  214.  
  215.    Search Strings:  FOOTERS, HEADERS, REPORT
  216.  
  217.    Problem Fixed by This Patch:
  218.  
  219.    This patch prevents Xtrieve PLUS report headers or footers with more
  220.    than one line from overwriting each other.
  221.  
  222.    * * * * * * * * *
  223.  
  224.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  225.  
  226.    Search Strings:  FILE_CREATION, PAGE, PREALLOC
  227.  
  228.    Problem Fixed by This Patch:
  229.  
  230.    Xtrieve PLUS uses the default page size (512 KB) if you selected the
  231.    Review Definitions option before selecting Finished-Create.  In this
  232.    situation, Xtrieve PLUS may also fail to preallocate the specified
  233.    number of pages.  This patch ensures that Xtrieve PLUS uses the page
  234.    size you specify, and also that Xtrieve PLUS preallocates the specified
  235.    number of pages.
  236.  
  237.    * * * * * * * * *
  238.  
  239.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  240.  
  241.    Search Strings:  BFLOAT, DISPLAY, FLOAT, MASK
  242.  
  243.    Problem Fixed by This Patch:
  244.  
  245.    This patch ensures that Xtrieve PLUS can redisplay the proper field
  246.    values when a display mask is used for a field of type float/bfloat.
  247.  
  248.    * * * * * * * * *
  249.  
  250.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  251.  
  252.    Search Strings:  SDF, TIME, TRANSLATE
  253.  
  254.    Problem Fixed by This Patch:
  255.  
  256.    This patch ensures that Xtrieve PLUS correctly translates time values to
  257.    Standard Data Format (SDF).
  258.  
  259.    * * * * * * * * *
  260.  
  261.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  262.  
  263.    Search Strings:  GROUP, HANG, LOCK UP, MODIFY, NESTED
  264.  
  265.    Problem Fixed by This Patch:
  266.  
  267.    When a report contains nested groups, attempting to modify or remove
  268.    the outer group's fields when no fields are defined causes the computer
  269.    to lock up.  This patch prevents the computer from locking up when you
  270.    modify or remove fields within the outermost group.
  271.  
  272.    * * * * * * * * *
  273.  
  274.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  275.  
  276.    Search Strings:  HANG, LOCK UP, RIGHTS, SECURITY
  277.  
  278.    Problem Fixed by This Patch:
  279.  
  280.    Your computer may lock up in the following situation:  you have security
  281.    installed on your dictionary files and are using the NetWare SQL
  282.    Requester (NSREQ) to access your files, and you attempt to access
  283.    file- or field-level rights for a user profile.  This patch prevents the
  284.    computer from locking up when you access the file- or field-level
  285.    rights.
  286.  
  287.    * * * * * * * * *
  288.  
  289.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  290.  
  291.    Search Strings:  PRINT, REPORT
  292.  
  293.    Problem Fixed by This Patch:
  294.  
  295.    A report may contain inaccurate information if any line in the report
  296.    (except for the last line on the page) is exactly the width of the page.
  297.    This patch ensures that the report contains accurate information.
  298.  
  299.    * * * * * * * * *
  300.  
  301.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  302.  
  303.    Search Strings:  BIT, DEFINITIONS, OFFSET, PRINT
  304.  
  305.    Problem Fixed by This Patch:
  306.  
  307.    If a file definition includes several bit data type fields adjacent to
  308.    each other, a file definition printout shows each bit field starting at
  309.    a new offset.  This patch corrects the placement of the bit fields.
  310.  
  311.    * * * * * * * * *
  312.  
  313.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  314.  
  315.    Search Strings:  25-LINE, BLANK, CHARACTERS, SCREEN, VGA
  316.  
  317.    Problem Fixed by This Patch:
  318.  
  319.    The following situations can occur in 25-line mode on a VGA monitor
  320.    after you exit Xtrieve PLUS:
  321.  
  322.    -   The screen goes blank, but you can still enter characters at the
  323.        keyboard.
  324.  
  325.    -   Keyboard characters are displayed as different characters on the
  326.        screen.
  327.  
  328.    This patch prevents either of these conditions from occurring.
  329.  
  330.    * * * * * * * * *
  331.  
  332.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  333.  
  334.    Search Strings:  EDIT, HEADING, MODIFY, TITLE
  335.  
  336.    Problem Fixed by This Patch:
  337.  
  338.    If you press Esc and then select Continue when editing or modifying a
  339.    view with a defined title field, the title data and heading may
  340.    disappear.  If you refresh the screen, the data reappears, but not the
  341.    heading.  This patch corrects the problem, so that both the title data
  342.    and heading are retained.
  343.  
  344.    * * * * * * * * *
  345.  
  346.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  347.  
  348.    Search Strings:  EDIT, DISPLAY, STRING
  349.  
  350.    Problem Fixed by This Patch:
  351.  
  352.    When you are entering data into a file with several string fields, any
  353.    data you enter in the second field does not appear on the screen when
  354.    you move to the following field, although the data is actually present
  355.    in the Btrieve file.  This patch allows the data in the second field to
  356.    appear as entered.
  357.  
  358.    * * * * * * * * *
  359.  
  360.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  361.  
  362.    Search Strings:  RECALL, REPORT, STORE
  363.  
  364.    Problem Fixed by This Patch:
  365.  
  366.    If you create (or recreate) a view, you must first store and recall it
  367.    before you can create and store a report for that view; otherwise, you
  368.    cannot recall the report after recalling the view.  This patch allows
  369.    you to create a report based on a view without first storing and
  370.    recalling the view.
  371.  
  372.    * * * * * * * * *
  373.  
  374.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  375.  
  376.    Search Strings:  CHARACTER, ESCAPE, HEX, REPORT
  377.  
  378.    Problem Fixed by This Patch:
  379.  
  380.    In a report containing an @esc or an @hexXX instruction (in which the
  381.    hexadecimal value of XX represents a nonprintable character), Xtrieve
  382.    PLUS does not include either the Escape character or the nonprintable
  383.    character in the report.  This patch causes Xtrieve PLUS to include
  384.    these characters in reports.
  385.  
  386.    * * * * * * * * *
  387.  
  388.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  389.  
  390.    Search Strings:  CASE, DEFINITION, DUPLICATE, FIELD
  391.  
  392.    Problem Fixed by This Patch:
  393.  
  394.    Xtrieve PLUS does not detect duplicate field names that differ only in
  395.    terms of case until you try to complete the file definition with either
  396.    Finished-Create or Finished-Don't Create.  This patch causes Xtrieve
  397.    PLUS to warn you of the duplication when you initially define the
  398.    duplicate field.
  399.  
  400.    * * * * * * * * *
  401.  
  402.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  403.  
  404.    Search Strings:  HANG, LOCK UP, SECURITY, SHOW, USER
  405.  
  406.    Problem Fixed by This Patch:
  407.  
  408.    Requesting user security information from Xtrieve PLUS can produce the
  409.    wrong information.  Also, with a dictionary user base of 255 to 500
  410.    users, selecting the SECURITY/USER/Show option may cause your computer
  411.    to lock up.  This patch causes Xtrieve PLUS to display the proper
  412.    information and prevents computer lockup.
  413.  
  414.    * * * * * * * * *
  415.  
  416.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  417.  
  418.    Search Strings:  123, 1-2-3, DATE, EXPORT, LOTUS
  419.  
  420.    Problem Fixed by This Patch:
  421.  
  422.    If you export dates to a Lotus 1-2-3 worksheet, dates before 9/17/89 may
  423.    appear as negative values.  This patch causes those dates to appear as
  424.    positive values.
  425.  
  426.    * * * * * * * * *
  427.  
  428.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  429.  
  430.    Search Strings:  EDIT, MODIFY, OUT OF LOCAL HEAP SPACE
  431.  
  432.    Problem Fixed by This Patch:
  433.  
  434.    When you attempt to modify the data in a view that is based on a long
  435.    restriction, you receive the message "Out of Local Heap Space in
  436.    Xtrieve."  This patch allows you to modify the data.
  437.  
  438.    * * * * * * * * *
  439.  
  440.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  441.  
  442.    Search Strings:  COMMAND FILE, MAKE, OWNER NAME
  443.  
  444.    Problem Fixed by This Patch:
  445.  
  446.    When you press F7 while running a command file in which you are prompted
  447.    for an owner name for a particular file, Xtrieve PLUS does not display
  448.    the Make option or all of the command files available.  This patch
  449.    ensures that Xtrieve PLUS displays the Make option and the complete menu
  450.    of command files.
  451.  
  452.    * * * * * * * * *
  453.  
  454.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  455.  
  456.    Search Strings:  226, EDIT, REMOVE
  457.  
  458.    Problem Fixed by This Patch:
  459.  
  460.    If you are using the EDIT/Remove option and attempt to select all
  461.    records, Xtrieve PLUS returns Status Code 226.  This patch enables you
  462.    to select all records in that situation.
  463.  
  464.    * * * * * * * * *
  465.  
  466.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  467.  
  468.    Search Strings:  ABORT, CONFIRM, RESTRICTION
  469.  
  470.    Problem Fixed by This Patch:
  471.  
  472.    If you press Esc while defining a restriction, Xtrieve PLUS might not
  473.    ask you to confirm that you want to abort the restriction definition.
  474.    This patch ensures that Xtrieve PLUS asks for confirmation before
  475.    proceeding.
  476.  
  477.    * * * * * * * * *
  478.  
  479.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  480.  
  481.    Search Strings:  DICTIONARY, HANG, LOCK UP, SHOW, /W
  482.  
  483.    Problem Fixed by This Patch:
  484.  
  485.    If you select Show from the DICTIONARY menu after starting Xtrieve PLUS
  486.    with the /W parameter set to 24, your computer locks up.  This patch
  487.    allows you to select Show in this situation.
  488.  
  489.    * * * * * * * * *
  490.  
  491.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  492.  
  493.    Search Strings:  CONFIGURE, FONT, PRINT, REPORT, STYLE
  494.  
  495.    Problem Fixed by This Patch:
  496.  
  497.    Xtrieve PLUS uses the default font (Courier 10 pitch) if you select a
  498.    proportional font or a downloaded font with the Style option of the
  499.    CONFIGURE/PRINT menu.  This patch ensures that Xtrieve PLUS prints your
  500.    report using the font you specify.
  501.  
  502.    * * * * * * * * *
  503.  
  504.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  505.  
  506.    Search Strings:  INDEX, OWNER NAME, SUPPLEMENTAL
  507.  
  508.    Problem Fixed by This Patch:
  509.  
  510.    This patch ensures you can define a supplemental index for a file that
  511.    has a Btrieve owner name.
  512.  
  513.    * * * * * * * * *
  514.  
  515.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  516.  
  517.    Search Strings:  BLANK, DATE, SDF, TRANSLATE
  518.  
  519.    Problem Fixed by This Patch:
  520.  
  521.    When translating data from SDF, Xtrieve PLUS replaces each blank date
  522.    ( /  /  ) with the date from the preceding record.  This patch ensures
  523.    that Xtrieve PLUS properly translates blank dates.
  524.  
  525.    * * * * * * * * *
  526.  
  527.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  528.  
  529.    Search Strings:  BTRIEVE, DICTIONARY, FIELD, SHOW
  530.  
  531.    Problem Fixed by This Patch:
  532.  
  533.    If your dictionary definition does not match the Btrieve file
  534.    definition, Xtrieve PLUS displays incorrect field information when you
  535.    use the DICTIONARY/Show option to examine the file's dictionary
  536.    definition.  This patch ensures that Xtrieve PLUS properly displays the
  537.    field information
  538.  
  539.    * * * * * * * * *
  540.  
  541.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  542.  
  543.    Search Strings:  DATE, MASK, SDF, TRANSLATE, YEAR
  544.  
  545.    Problem Fixed by This Patch:
  546.  
  547.    When translating to Standard Data Format (SDF), Xtrieve PLUS translates
  548.    date fields with a mask of mm/dd/yyyy as mm/dd/yy.  When translating
  549.    four-digit year masks from SDF, Xtrieve PLUS repeats the first two
  550.    digits of the year. (For example, it translates 1992 as 1919.)  This
  551.    patch ensures that Xtrieve PLUS properly translates date fields to
  552.    and from of SDF.
  553.  
  554.    * * * * * * * * *
  555.  
  556.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  557.  
  558.    Search Strings:  INDEX, JOIN, SEMICOLON, GARBAGE
  559.  
  560.    Problem Fixed by This Patch:
  561.  
  562.    Xtrieve PLUS displays graphic characters at the bottom of the screen
  563.    when joining two files on an index that contains a semicolon (;).  This
  564.    patch enables Xtrieve PLUS to join files in this situation without
  565.    displaying extraneous characters.
  566.  
  567.    * * * * * * * * *
  568.  
  569.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  570.  
  571.    Search Strings:  LOGICAL, MASK, SDF, TRANSLATE, Y-N
  572.  
  573.    Problem Fixed by This Patch:
  574.  
  575.    When Xtrieve PLUS translates a logical type field with a mask of y-n to
  576.    SDF, it translates all values as n.  This patch ensures that Xtrieve
  577.    PLUS properly translates the data.
  578.  
  579.    * * * * * * * * *
  580.  
  581.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  582.  
  583.    Search Strings:  DIVIDE OVERFLOW, PRINT, REPORT
  584.  
  585.    Problem Fixed by This Patch:
  586.  
  587.    When you attempt to print a report to either a file or a printer,
  588.    Xtrieve PLUS returns the message "Divide Overflow."  This patch allows
  589.    you to print a report to a file or a printer.
  590.  
  591.    * * * * * * * * *
  592.  
  593.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  594.  
  595.    Search Strings:  249, RECALL, STORE, VIEW
  596.  
  597.    Problem Fixed by This Patch:
  598.  
  599.    If you attempt to recall a view when more than 249 views are stored in
  600.    VIEW.DDF, Xtrieve PLUS returns the message "There Are No Views Stored in
  601.    This Dictionary."  This patch allows you to recall a view in this
  602.    situation.
  603.  
  604.    * * * * * * * * *
  605.  
  606.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  607.  
  608.    Search Strings:  228, COMMAND FILE, EDIT, FPROMPT
  609.  
  610.    Problem Fixed by This Patch:
  611.  
  612.    When attempting to execute the FPROMPT command in a command file,
  613.    Xtrieve PLUS recalls the view to be edited but then returns Status Code
  614.    228 when you attempt to edit a field.  Also, Xtrieve PLUS displays
  615.    incorrect data in the field.  This patch ensures that Xtrieve PLUS
  616.    properly executes the FPROMPT command in command files.
  617.  
  618.    * * * * * * * * *
  619.  
  620.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  621.  
  622.    Search Strings:  1-2-3, LOTUS, REPORT, TIME, TRANSLATE
  623.  
  624.    Problem Fixed by This Patch:
  625.  
  626.    Xtrieve PLUS does not translate fields of data type time from reports
  627.    to Lotus 1-2-3 worksheets.  This patch ensures that Xtrieve PLUS
  628.    can properly translate reports containing time fields to Lotus 1-2-3.
  629.  
  630.    * * * * * * * * *
  631.  
  632.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  633.  
  634.    Search Strings:  FIELD NAME, JOIN
  635.  
  636.    Problem Fixed by This Patch:
  637.  
  638.    This patch ensures that Xtrieve PLUS properly joins files that contain
  639.    identical field names.
  640.  
  641.    * * * * * * * * *
  642.  
  643.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  644.  
  645.    Search Strings:  209, DICTIONARY, FILE, MODIFY, SECURITY
  646.  
  647.    Problem Fixed by This Patch:
  648.  
  649.    If you attempt to use the SECURITY/MODIFY/File option when there are no
  650.    data files defined and the SWITCHES/DICTIONARY/Show option is set to No,
  651.    Xtrieve PLUS returns Status Code 209 instead of the error message
  652.    "Dictionary is Empty."  This patch ensures that Xtrieve PLUS returns the
  653.    correct error message in this situation.
  654.  
  655.    * * * * * * * * *
  656.  
  657.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  658.  
  659.    Search Strings:  ERROR WRITING OUTPUT, SDF, TRANSLATE, USER-DEFINED,
  660.             ZSTRING
  661.  
  662.    Problem Fixed by This Patch:
  663.  
  664.    Xtrieve PLUS returns the message "Error Writing Output" when you
  665.    attempt to translate a user-defined field of type zstring (using
  666.    Left Chars or Right Chars function) to SDF.  This patch ensures that
  667.    Xtrieve PLUS properly translates zstring fields to SDF.
  668.  
  669.    * * * * * * * * *
  670.  
  671.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  672.  
  673.    Search Strings:  81, BROWSE, EDIT, HANG, LOCK UP, MODIFY
  674.  
  675.    Problem Fixed by This Patch:
  676.  
  677.    When you return to Browse mode from EDIT/Modify mode, Xtrieve PLUS does
  678.    not release the multiple-record locks; consequently, Xtrieve PLUS
  679.    returns Status Code 81 (Lock Error) the next time you attempt to switch
  680.    to EDIT/Modify mode.  This patch ensures that Xtrieve PLUS releases
  681.    multiple-record locks when you return to Browse mode from EDIT/Modify
  682.    mode.
  683.  
  684.    * * * * * * * * *
  685.  
  686.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  687.  
  688.    Search Strings:  HANG, JOIN, KEY, LOCK UP, PRIMARY
  689.  
  690.    Problem Fixed by This Patch:
  691.  
  692.    When you are joining two large files, basing the join on more than one
  693.    primary field causes you computer to lock up.  This patch ensures you
  694.    can join files in this situation.
  695.  
  696.    * * * * * * * * *
  697.  
  698.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  699.  
  700.    Search Strings:  GLOBAL, OUT OF LOCAL HEAP SPACE, RIGHTS, SECURITY,
  701.             USER
  702.  
  703.    Problem Fixed by This Patch:
  704.  
  705.    When you add a user with global rights only, show that user's rights,
  706.    press Esc, and then press F7 to record a command file, Xtrieve PLUS
  707.    returns the message "Out of Local Heap Space in Xtrieve."  This patch
  708.    ensures you can perform this operation without receiving an error.
  709.  
  710.    * * * * * * * * *
  711.  
  712.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  713.  
  714.    Search Strings:  COMMAND FILE, OUT OF LOCAL HEAP SPACE, SHIFT-F1
  715.  
  716.    Problem Fixed by This Patch:
  717.  
  718.    When you replay a command file and then press Shift-F1 to select
  719.    another command file to replay, Xtrieve PLUS returns the message "Out of
  720.    Local Heap Space in Xtrieve."  This patch ensures you can perform this
  721.    operation without receiving an error message.
  722.  
  723.    * * * * * * * * *
  724.  
  725.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  726.  
  727.    Search Strings:  DISPLAY, JOIN, TRUNCATE, VIEW
  728.  
  729.    Problem Fixed by This Patch:
  730.  
  731.    If you join several views together, return to the MAIN menu, and then
  732.    access the view you created, Xtrieve PLUS truncates the list of joined
  733.    views at the top of your view screen.  This patch ensures that Xtrieve
  734.    PLUS properly displays the list of joined views.
  735.  
  736.    * * * * * * * * *
  737.  
  738.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  739.  
  740.    Search Strings:  DISPLAY, FIELD, SORT, USER-DEFINED, VIEW
  741.  
  742.    Problem Fixed by This Patch:
  743.  
  744.    If your sort is based on a user-defined field, Xtrieve PLUS incorrectly
  745.    displays the field by which your view is sorted in the upper right
  746.    corner of the definition window.  This patch ensures that Xtrieve PLUS
  747.    displays this information correctly.
  748.  
  749.    * * * * * * * * *
  750.  
  751.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  752.  
  753.    Search Strings:  CONFIGURATION, HANG, LOCK UP, LOG IN, MASTER
  754.  
  755.    Problem Fixed by This Patch:
  756.  
  757.    If you use the Configuration option to log in as a different user after
  758.    logging in as MASTER, your computer locks up.  This patch allows you to
  759.    perform this operation without locking up your computer.
  760.  
  761.    * * * * * * * * *
  762.  
  763.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  764.  
  765.    Search Strings:  284, ADD, CLEAR, FIELD, RECORD
  766.  
  767.    Problem Fixed by This Patch:
  768.  
  769.    If you attempt to add a record without one of the required fields,
  770.    Xtrieve PLUS returns Status Code 284 and then clears all the information
  771.    you entered.  This patch ensures that Xtrieve PLUS does not clear the
  772.    information you entered.
  773.  
  774.    * * * * * * * * *
  775.  
  776.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  777.  
  778.    Search Strings:  284, ATTRIBUTE, ERROR WRITING OUTPUT, TRANSLATE, VIEW
  779.  
  780.    Problem Fixed by This Patch:
  781.  
  782.    If you attempt to translate the current view to a retained view with an
  783.    invalid field attribute, Xtrieve PLUS returns the message "Error Writing
  784.    Output" instead of Status Code 284.  This patch ensures that Xtrieve
  785.    PLUS returns Status Code 284 in this situation.
  786.  
  787.    * * * * * * * * *
  788.  
  789.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  790.  
  791.    Search Strings:  99/, ADD, EDIT, INTEGER, MASK, RANGE
  792.  
  793.    Problem Fixed by This Patch:
  794.  
  795.    If you use the EDIT/Add option to enter data into an integer field with
  796.    the mask 99/ and a range of '1'..'12', Xtrieve PLUS does not accept any
  797.    entry in that field.  This patch ensures that Xtrieve PLUS allows you
  798.    to enter data in this situation.
  799.  
  800.    * * * * * * * * *
  801.  
  802.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  803.  
  804.    Search Strings:  BROWSE, EDIT, FORM, OFFSET, REMOVE
  805.  
  806.    Problem Fixed by This Patch:
  807.  
  808.    Xtrieve PLUS does not correctly format data when you use the
  809.    EDIT/Remove option following a FORM/Browse operation.  This patch
  810.    ensures that Xtrieve PLUS displays data at the correct offset.
  811.  
  812.    * * * * * * * * *
  813.  
  814.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  815.  
  816.    Search Strings:  HANG, LOCK UP, MENU, OPERATOR, RESTRICTION,
  817.             USER-DEFINED
  818.  
  819.    Problem Fixed by This Patch:
  820.  
  821.    Xtrieve PLUS locks up your workstation if you attempt to use a
  822.    user-defined menu containing restriction operators that are longer
  823.    than those supplied with Xtrieve PLUS.  This patch ensures that you
  824.    can use such a menu.
  825.  
  826.    * * * * * * * * *
  827.  
  828.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  829.  
  830.    Search Strings:  CONDITIONAL, HANG, LOCK UP, FIELD, JOIN, NESTED,
  831.             USER-DEFINED
  832.  
  833.    Problem Fixed by This Patch:
  834.  
  835.    If you create a nested, conditional, user-defined field in a joined
  836.    view, your computer locks up.  This patch ensures that Xtrieve PLUS
  837.    returns the error message "Out of Local Heap Space in Xtrieve" instead
  838.    of locking up your computer.
  839.  
  840.    * * * * * * * * *
  841.  
  842.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  843.  
  844.    Search Strings:  51, ENCRYPT, INVALID OWNER, OWNER NAME, SUPPLEMENTAL
  845.  
  846.    Problem Fixed by This Patch:
  847.  
  848.    If you add a supplemental index to an encrypted Btrieve file that
  849.    requires an owner name for any access (ENCRYPT/Any), Xtrieve PLUS
  850.    returns Status Code 51 (Invalid Owner).  This patch ensures you can
  851.    perform this operation without receiving Status Code 51.
  852.  
  853.    * * * * * * * * *
  854.  
  855.    Platform/Product:  DOS - XTRIEVE.EXE, v4.10
  856.  
  857.    Search Strings:  CENTER, JUSTIFY, RIGHT
  858.  
  859.    Problem Fixed by This Patch:
  860.  
  861.    This patch ensures that you can right justify a field after you have
  862.    center justified it.
  863.  
  864.    * * * * * * * * *
  865.  
  866.    Platform/Product:  DOS - MAKE_XTA.EXE, v4.10
  867.  
  868.    Search Strings:  HANG, LOCK UP, MAKE_XTA, TRANSLATE, LARGE VIEWS
  869.  
  870.    Problem Fixed:
  871.  
  872.    If you attempt to use the MAKE_XTA utility to translate fields of large
  873.    views, your computer locks up.  This update ensures you can perform
  874.    this operation.
  875.  
  876.    * * * * * * * * *
  877.  
  878.    Platform/Product:  DOS - MAKE_XTA.EXE, v4.10
  879.  
  880.    Search Strings:  JOIN, MAKE_XTA, TRANSLATE
  881.  
  882.    Problem Fixed by This Patch:
  883.  
  884.    This update ensures that the MAKE_XTA utility properly translates joined
  885.    views.
  886.  
  887.    * * * * * * * * *
  888.  
  889.    Platform/Product:  DOS - MAKE_XTA.EXE, v4.10
  890.  
  891.    Search Strings:  MAKE_XTA, RESTRICTION, USER-DEFINED, VIEW
  892.  
  893.    Problem Fixed by This Patch:
  894.  
  895.    This update ensures that the MAKE_XTA utility can recall a view
  896.    definition that includes a user-defined field or restriction.
  897.  
  898.    * * * * * * * * *
  899.  
  900.    Platform/Product:  DOS - MAKE_XTA.EXE, v4.10
  901.  
  902.    Search Strings:  LAYOUT, MAKE_XTA, REPORT, SUMMARY, TRANSLATE,
  903.             USER-DEFINED
  904.  
  905.    Problem Fixed by This Patch:
  906.  
  907.    This update ensures that the MAKE_XTA utility properly translates
  908.    information from a report layout file with a user-defined summary field.
  909.  
  910.    * * * * * * * * *
  911.  
  912.    Platform/Product:  DOS - XCFP.EXE, v4.10
  913.  
  914.    Search Strings:  COMMAND FILE, MOUSE, POSDIRECT, WINDOW, XCFP
  915.  
  916.    Problem Fixed by This Patch:
  917.  
  918.    This update ensures that the XCFP command file processor correctly
  919.    interprets mouse commands with the window identifier POSDIRECT.
  920.  
  921.    * * * * * * * * *
  922.  
  923.    Platform/Product:  DOS - XMENU.EXE, v4.10
  924.  
  925.    Search Strings:  MENU, XMENU, XTRIEVE.MEN
  926.  
  927.    Problem Fixed by This Patch:
  928.  
  929.    If you attempt to open XTRIEVE.MEN, the XMENU utility returns the
  930.    message, "'XTRIEVE.MEN' File Is Not a Compatible Menu File for Xtrieve."
  931.    This update ensures that XMENU recognizes XTRIEVE.MEN as a compatible
  932.    menu file.
  933.  
  934.    * * * * * * * * *
  935.  
  936.  
  937. XQLP v2.11a and XQLPO v2.11a Patch Set Descriptions
  938. ---------------------------------------------------
  939.  
  940.    Platform/Product:  XQLP for DOS - XQLP.EXE, v2.11a
  941.                       XQLPO for DOS - XQLPO.EXE, v2.11a
  942.  
  943.    Search Strings:  FETCH, CURRENT
  944.  
  945.    Problem Fixed by This Patch:
  946.  
  947.    xFetch/XQLFetch CURRENT operations can skip the current record and
  948.    return the next record that meets the restriction if the restriction is
  949.    in the following format:
  950.  
  951.          "field = 'value' OR field = 'value' OR...."
  952.  
  953.    This patch ensures that xFetch/XQLFetch CURRENT operations return the
  954.    current record in this situation.
  955.  
  956.    * * * * * * * * *
  957.  
  958.    Platform/Product:  XQLP for DOS - XQLP.EXE, v2.11a
  959.                       XQLPO for DOS -XQLPO.EXE, v2.11a
  960.  
  961.    Search Strings:  QUERY, TABLE, ALTER, HANG, LOCK UP
  962.  
  963.    Problem Fixed by This Patch:
  964.  
  965.    The workstation may hang when XQL attempts to execute a query against a
  966.    view and then the tables used to create the view are altered.  That is,
  967.    the tables are defined, a view is created on the tables, the tables are
  968.    altered, and the view (which is no longer applicable) is used, causing
  969.    XQL to hang the workstation.  This patch prevents the workstation from
  970.    locking up.
  971.  
  972.    * * * * * * * * *
  973.  
  974.    Platform/Product:  XQLP for DOS - XQLP.EXE, v2.11a
  975.                       XQLPO for DOS -XQLPO.EXE, v2.11a
  976.  
  977.    Search Strings:  3, GLOBAL DATA VARIABLE
  978.  
  979.    Problem Fixed by This Patch:
  980.  
  981.    If the record length of the first table in a view is greater than 2062
  982.    bytes, XQL may overwrite global data variables.  One possible symptom of
  983.    this problem is that Btrieve returns Status Code 3 when XQL tries to
  984.    access the dictionary files.  This patch prevents XQL from overwriting
  985.    global data variables in this situation.
  986.  
  987.    * * * * * * * * *
  988.  
  989.    Platform/Product:  XQLP for DOS - XQLP.EXE, v2.11a
  990.                       XQLPO for DOS -XQLPO.EXE, v2.11a
  991.  
  992.    Search Strings:  XREMALL, REJECT
  993.  
  994.    Problem Fixed by This Patch:
  995.  
  996.    If the reject count passed to xRemall is not -1, and xRemall returned
  997.    because the maximum reject count was reached, your application may
  998.    enter an infinite loop.  Depending on the restriction and the contents
  999.    of the data file, xRemall may continue to reject the same set of records
  1000.    without returning an end-of-file status.  This patch prevents your
  1001.    application from entering an infinite loop in this situation.
  1002.  
  1003.    * * * * * * * * *
  1004.  
  1005.  
  1006. XQLP(O) v2.11b Optional Patches
  1007. -------------------------------
  1008.  
  1009.    Optional patches are available for XQLP(O) v2.11b.  These patches can
  1010.    only be applied after the 2.11a patch set has been applied to the
  1011.    original 2.11a version of XQLP(O).
  1012.  
  1013.    These patches can be found in XQLOPT.ZIP, included with this patch set.
  1014.  
  1015.  
  1016. ================================================================================
  1017. Xtrieve PLUS v4.11 for DOS
  1018. ==========================
  1019.  
  1020.    The following information pertains to the DOS environment patches for
  1021.    the Xtrieve PLUS v4.11 programs and utilities.
  1022.  
  1023.  
  1024. Original File Information
  1025. -------------------------
  1026.  
  1027.    To ensure you are patching or replacing the original files, compare the files
  1028.    to be patched or replaced with those in the following list.    This list shows
  1029.    the byte size and the date and time stamps for the original release.
  1030.  
  1031.    Patch this file:
  1032.             XTRIEVE  EXE  v4.11  454848   8-14-91  11:23a
  1033.  
  1034.    Replace these files:
  1035.             MAKE_XTA EXE  v4.11   65712   7-16-91    7:20p
  1036.             XCFP     EXE  v4.11   44032   7-17-91    9:19a
  1037.             XMENU     EXE  v4.11   98912   7-16-91    8:28p
  1038.             XTRIEVE  MSG          39017   8-11-92    3:59p
  1039.             XTRIEVE  HLP         221184   3-20-92    5:55p
  1040.             XHFP     EXE  v4.11   16672   6-25-92    5:47p
  1041.             XTRIEVE  MEN  v4.11   13347   8-11-92    3:59p
  1042.  
  1043.  
  1044. Xtrieve PLUS v4.11 Patch Set Descriptions
  1045. -----------------------------------------
  1046.  
  1047.    This section describes each patch in the patch set.    For each patch, the
  1048.    description includes one or more search strings.  These search strings
  1049.    indicate areas in which you may encounter the problem that the patch
  1050.    addresses.  The search strings may help you quickly determine whether the
  1051.    patch you need for a specific problem is included in this patch set.
  1052.  
  1053.    NOTE:  In some cases, the text describes a problem or reported bug that the
  1054.       update does NOT fix.    In those cases, use the workaround provided.
  1055.  
  1056.    * * * * * * * * *
  1057.  
  1058.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1059.  
  1060.    Search Strings:  DISPLAY ERRORS
  1061.  
  1062.    Problem Fixed by This Patch:
  1063.  
  1064.    In the Report Layout screen, when you insert a field between two fields that
  1065.    take up a relatively large portion of the screen, Xtrieve PLUS redraws the
  1066.    screen incorrectly.    This patch does not contain a fix; Xtrieve PLUS
  1067.    accurately stores the new data.
  1068.  
  1069.    * * * * * * * * *
  1070.  
  1071.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1072.  
  1073.    Search Strings:  F8, HANG, MODIFYING, REPORT LAYOUT
  1074.  
  1075.    Problem Fixed by This Patch:
  1076.  
  1077.    When you repeatedly use the key sequence Shift+F8, F8, and Esc when modifying
  1078.    or viewing groups or fields in a report layout, Xtrieve PLUS terminates.
  1079.    This patch ensures that Xtrieve PLUS properly closes and reopens the report
  1080.    layout windows, thus preventing Xtrieve PLUS from terminating.
  1081.  
  1082.    * * * * * * * * *
  1083.  
  1084.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1085.  
  1086.    Search Strings:  GROUP FIELD, GROUP SUMMARY, REPORT FIELD, REPORT SUMMARY
  1087.  
  1088.    Problem Fixed by This Patch:
  1089.  
  1090.    If you use a report field in a report field summary or a group field in a
  1091.    group field summary, Xtrieve PLUS does not allow you to remove or modify the
  1092.    field.  This patch ensures that Xtrieve PLUS allows you to remove or modify
  1093.    such fields.
  1094.  
  1095.    * * * * * * * * *
  1096.  
  1097.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1098.  
  1099.    Search Strings:  FORM/ADD EDIT SCREEN, INVALID RECORD
  1100.  
  1101.    Problem Fixed by This Patch:
  1102.  
  1103.    If you attempt to add an invalid record using the Form/Add edit screen,
  1104.    Xtrieve PLUS exits the Form/Add edit screen and returns to the Form menu.
  1105.    This patch ensures that if an error occurs when you attempt to add a record,
  1106.    Xtrieve PLUS remains at the edit screen.
  1107.  
  1108.    * * * * * * * * *
  1109.  
  1110.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1111.  
  1112.    Search Strings:  REPORT LAYOUT
  1113.  
  1114.    Problem Fixed by This Patch:
  1115.  
  1116.    When XQL and Btrieve are loaded by Xtrieve PLUS, report layouts may become
  1117.    corrupt in memory after you print a report.    This patch ensures that Xtrieve
  1118.    PLUS correctly maintains report layouts.
  1119.  
  1120.    * * * * * * * * *
  1121.  
  1122.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1123.  
  1124.    Search Strings:  HANG, REMOVE GROUP
  1125.  
  1126.    Problem Fixed by This Patch:
  1127.  
  1128.    If you remove a group from a report and then attempt to remove another
  1129.    group, Xtrieve PLUS displays a repetitive list of groups from which to
  1130.    choose.  In addition, if you choose one of the listed groups, Xtrieve PLUS
  1131.    causes the workstation to freeze.  This patch ensures that Xtrieve PLUS
  1132.    correctly displays lists of groups.
  1133.  
  1134.    * * * * * * * * *
  1135.  
  1136.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1137.  
  1138.    Search Strings:  BLANKS, IMPORT DATA, SDF
  1139.  
  1140.    Problem Fixed by This Patch:
  1141.  
  1142.    Xtrieve PLUS incorrectly imports data in Standard Data Format (SDF) if
  1143.    blanks separate the data elements, as in the following example:
  1144.  
  1145.    "Firstname", "Middlename", "Lastname"
  1146.  
  1147.    This patch ensures that Xtrieve PLUS correctly imports SDF data.
  1148.  
  1149.    * * * * * * * * *
  1150.  
  1151.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1152.  
  1153.    Search Strings:  LVAR, NOTE, TRANSLATE, VARIABLE-LENGTH FIELDS
  1154.  
  1155.    Problem Fixed by This Patch:
  1156.  
  1157.    Xtrieve PLUS does not correctly process view-to-view translations on
  1158.    variable-length fields that are not of the same type.  For example, you
  1159.    cannot accurately translate a note field into an lvar field.  This patch
  1160.    ensures that Xtrieve PLUS correctly performs such translations.
  1161.  
  1162.    * * * * * * * * *
  1163.  
  1164.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1165.  
  1166.    Search Strings:  CREATE FILE, PAGE, PREALLOCATION
  1167.  
  1168.    Problem Fixed by This Patch:
  1169.  
  1170.    When you are creating files, Xtrieve PLUS allows you to preallocate no more
  1171.    than 32,767 pages.  This patch ensures that Xtrieve PLUS allows you to
  1172.    preallocate up to 65,535 pages.
  1173.  
  1174.    * * * * * * * * *
  1175.  
  1176.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1177.  
  1178.    Search Strings:  BTRIEVE, NEW COMMAND LINE OPTIONS, UNLOAD, XQL
  1179.  
  1180.    Problem Fixed by This Patch:
  1181.  
  1182.    Xtrieve PLUS does not unload Btrieve or XQL from memory if you loaded Btrieve
  1183.    or XQL before you entered Xtrieve PLUS.  If you do not have the utilities
  1184.    BUTIL or NSUTIL, you cannot unload XQL or Btrieve from memory.  This patch
  1185.    makes available two new command line options you can specify when you load
  1186.    Xtrieve PLUS:
  1187.  
  1188.    /ua       Unloads both XQL and Btrieve when you exit Xtrieve PLUS
  1189.  
  1190.    /ux       Unloads only XQL when you exit Xtrieve PLUS
  1191.  
  1192.    * * * * * * * * *
  1193.  
  1194.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1195.  
  1196.    Search Strings:  CONDITIONAL, FIELD LIST, SCALAR FUNCTIONS,
  1197.             USER-DEFINED FIELDS
  1198.  
  1199.    Problem:
  1200.  
  1201.    Xtrieve PLUS may not display all available fields in a field list when you
  1202.    are defining a user-defined field that includes nested conditions or nested
  1203.    scalar functions, as in the following example expression:
  1204.  
  1205.    Result = SUBSTRING( SUBSTRING( SUBSTRING( Field3,5,20),2,Field2),5,Field1)
  1206.  
  1207.    Workaround:
  1208.  
  1209.    For each level of nesting, create a temporary, user-defined field, as in the
  1210.    following example:
  1211.  
  1212.    TempField1 = SUBSTRING( Field3,5,20)
  1213.  
  1214.    TempField2 = SUBSTRING( TempField1,2,Field2)
  1215.  
  1216.    TempField3 = SUBSTRING( TempField2,5,Field1)
  1217.  
  1218.    Since Xtrieve PLUS embeds the temporary field definitions in the substring
  1219.    field that references it, you can delete the interim temporary fields,
  1220.    resulting in a single, user-defined field, as in the following example:
  1221.  
  1222.    Result = TempField3
  1223.  
  1224.    * * * * * * * * *
  1225.  
  1226.    Product/Platform:  DOS - XTRIEVE.EXE, v4.11
  1227.  
  1228.    Search Strings:  DECIMAL POINTS, INTEGER FIELDS, MASKS
  1229.  
  1230.    Problem:
  1231.  
  1232.    If you place a mask that contains decimal points (such as ZZZ,ZZ9.99) on an
  1233.    integer field, you may get unexpected results in report summary fields.  For
  1234.    example, if the field's data is 38,470.00, the masked result is 384.70.
  1235.  
  1236.    Workaround:
  1237.  
  1238.    Masks on integer fields should not contain decimal points.  Use a more
  1239.    appropriate data type, such as decimal, float, money, or numeric.
  1240.  
  1241.    * * * * * * * * *
  1242.  
  1243.    Product/Platform:  DOS - XTRIEVE.PDB
  1244.  
  1245.    Search Strings:  PRINTER, TABLOID SETTING
  1246.  
  1247.    Problem:
  1248.  
  1249.    The Tabloid setting of the XTRIEVE.PDB file specifies the Epson LQ-1500/2.0
  1250.    printer instead of the IBM PC graphics printer.
  1251.  
  1252.    Workaround:
  1253.  
  1254.    Change the Tabloid setting as follows.
  1255.  
  1256.    1.  At a DOS workstation, enter SLATE XTRIEVE.PDB.
  1257.  
  1258.    2.  In the SLATE utility, follow these steps to set the Tabloid setting:
  1259.  
  1260.        a.  Select the Add/Edit Devices (Ptr Connections) option from the main
  1261.        menu.
  1262.  
  1263.        b.  Select the 3001 Tabloid option from the Devices menu.
  1264.  
  1265.        c.  Use the Tab key to move to the Ptr Mfg field and press F9 to display
  1266.        a list of printer manufacturers.
  1267.  
  1268.        d.  Select IBM.
  1269.  
  1270.        e.  Use the Tab key to move to the Ptr Type field and press F9 to display
  1271.        a list of printer types.
  1272.  
  1273.        f.  Select PC Graphics Printer.
  1274.  
  1275.    3.  To exit SLATE, press F10 three times.
  1276.  
  1277.    * * * * * * * * *
  1278.  
  1279.    Product/Platform:  DOS - MAKE_XTA.EXE, v4.11
  1280.  
  1281.    Search Strings:  3, HANG, OPEN VIEWS
  1282.  
  1283.    Problem Fixed by This Patch:
  1284.  
  1285.    The MAKE_XTA utility hangs or returns Status Code 3 (File Not Open) when you
  1286.    attempt to open certain views.  This patch ensures that MAKE_XTA can open
  1287.    such views.
  1288.  
  1289.    * * * * * * * * *
  1290.  
  1291.    Product/Platform:  DOS - MAKE_XTA.EXE, v4.11
  1292.  
  1293.    Search Strings:  FIELD NAMES, LOWERCASE, UPPERCASE
  1294.  
  1295.    Problem Fixed by This Patch:
  1296.  
  1297.    The MAKE_XTA utility converts all letters in user-defined field names to
  1298.    uppercase.  This patch ensures that MAKE_XTA preserves lowercase letters in
  1299.    field names.
  1300.  
  1301.    * * * * * * * * *
  1302.  
  1303.    Product/Platform:  DOS - MAKE_XTA.EXE, v4.11
  1304.  
  1305.    Search Strings:  EQJOIN, EQUAL, JOIN, KEYWORD, NULL, NULLJOIN
  1306.  
  1307.    Problem Fixed by This Patch:
  1308.  
  1309.    The MAKE_XTA utility inserts incorrect keywords in .XTA files that contain
  1310.    file joins.    For example, MAKE_XTA uses the keyword EQUAL when it should use
  1311.    the keyword EQJOIN.    This patch ensures that MAKE_XTA inserts the correct
  1312.    keywords.
  1313.  
  1314.    * * * * * * * * *
  1315.  
  1316.    Product/Platform:  DOS - MAKE_XTA.EXE, v4.11
  1317.  
  1318.    Search Strings:  ADD KEYWORD, REPORT LAYOUT, SUM
  1319.  
  1320.    Problem Fixed by This Patch:
  1321.  
  1322.    If a report layout contains the calculation type SUM, the MAKE_XTA
  1323.    utility inserts an extra .ADD. keyword in the XTA file.  This patch ensures
  1324.    that MAKE_XTA inserts the correct number of .ADD. keywords.
  1325.  
  1326.    * * * * * * * * *
  1327.  
  1328.    Product/Platform:  DOS - MAKE_XTA.EXE, v4.11
  1329.  
  1330.    Search Strings:  BIT FIELDS, CONSECUTIVE FIELDS
  1331.  
  1332.    Problem Fixed by This Patch:
  1333.  
  1334.    If a dictionary contains more two or more adjacent fields of type bit, the
  1335.    MAKE_XTA utility inserts only the first bit field in the .XTA file.    This
  1336.    patch ensures that MAKE_XTA inserts all bit fields.
  1337.  
  1338.    * * * * * * * * *
  1339.  
  1340.    Product/Platform:  DOS - MAKE_XTA.EXE, v4.11
  1341.  
  1342.    Search Strings:  AUTOINC, INDEX ATTRIBUTES
  1343.  
  1344.    Problem Fixed by This Patch:
  1345.  
  1346.    The MAKE_XTA utility incorrectly extracts the index attributes of fields of
  1347.    type autoinc.  This patch ensures that MAKE_XTA retains index attributes as
  1348.    defined in the original file.
  1349.  
  1350.    * * * * * * * * *
  1351.  
  1352.    Product/Platform:  DOS - MAKE_XTA.EXE, v4.11
  1353.  
  1354.    Search Strings:  EXTRACT FILES, SUPPLEMENTAL INDEX
  1355.  
  1356.    Problem Fixed by This Patch:
  1357.  
  1358.    The MAKE_XTA utility fails when attempting to extract files that contain
  1359.    supplemental indexes.  This patch ensures that MAKE_XTA correctly extracts
  1360.    supplemental indexes.
  1361.  
  1362.    * * * * * * * * *
  1363.  
  1364.    Product/Platform:  DOS - MAKE_XTA.EXE, v4.11
  1365.  
  1366.    Search Strings:  DESCRIPTIVE FILENAME
  1367.  
  1368.    Problem Fixed by This Patch:
  1369.  
  1370.    If a descriptive filename is shorter than the actual filename, the MAKE_XTA
  1371.    utility pads the rest of the descriptive filename with characters from the
  1372.    actual filename.  For example, given a descriptive filename of FILE and an
  1373.    actual filename of TESTING, MAKE_XTA converts the descriptive filename to
  1374.    FILEING.  This patch ensures that MAKE_XTA inserts the correct descriptive
  1375.    filename into the generated .XTA file.
  1376.  
  1377.    * * * * * * * * *
  1378.  
  1379.    Product/Platform:  DOS - MAKE_XTA.EXE, v4.11
  1380.  
  1381.    Search Strings:  EXTRACT VIEWS, USER-DEFINED FIELDS
  1382.  
  1383.    Problem Fixed by This Patch:
  1384.  
  1385.    The MAKE_XTA utility incorrectly extracts views containing relatively large
  1386.    user-defined fields.  This patch ensures that MAKE_XTA correctly extracts
  1387.    such views.
  1388.  
  1389.    * * * * * * * * *
  1390.  
  1391.    Product/Platform:  DOS - XCFP.EXE, v4.11
  1392.  
  1393.    Search Strings:  COMMANDS WITH NUMERALS, PAGE SIZE
  1394.  
  1395.    Problem Fixed by This Patch:
  1396.  
  1397.    The Xtrieve PLUS Command File Processor (XCFP) utility does not recognize the
  1398.    command that specifies page size since the command begins with a numeral.
  1399.    This patch ensures that XCFP recognizes commands that begin with numerals.
  1400.  
  1401.  
  1402. ================================================================================
  1403. Documentation Updates
  1404. =====================
  1405.  
  1406.    The following sections contain documentation updates for the "Xtrieve
  1407.    PLUS User's Manual" and the "Xtrieve PLUS Tutorial."
  1408.  
  1409.    NOTE:  The documentation updates that follow are in addition to any
  1410.           documentation updates noted in the Readme file of the original
  1411.           product.
  1412.  
  1413.    Note the following changes to the "Xtrieve PLUS User's Manual":
  1414.  
  1415.    -  Page vi:  Replace the section "Where To Get Help" with the following.
  1416.  
  1417.       Where To Get Help
  1418.  
  1419.       Novell offers support through a wide range of programs.  This section
  1420.       lists sources of help that are available for the Novell Database
  1421.       Products line.
  1422.  
  1423.  
  1424.       Telephone Technical Support
  1425.  
  1426.       Novell's telephone technical support program provides helpful
  1427.       information about getting the best results from your Novell product.
  1428.       Refer to the section "Contacting Novell" for information about
  1429.       contacting Novell for technical support.  If you are contacting
  1430.       Novell for a follow-up on a previous technical support issue, please
  1431.       be ready to provide your open call reference number.
  1432.  
  1433.  
  1434.       International Technical Support
  1435.  
  1436.       International customers may find the Direct Connect (SM) Fax
  1437.       International program useful.  This program provides priority
  1438.       handling of fax support, which allows international customers to
  1439.       obtain technical support without worrying about high telephone costs
  1440.       and time zone differences.  Novell encourages customers who reside
  1441.       outside the continental United States and Canada to contact their
  1442.       local Novell office or Novell authorized reseller for more
  1443.       information about international support options.  Refer to the
  1444.       section "Contacting Novell" for the fax number for international
  1445.       technical support.
  1446.  
  1447.  
  1448.       Product Information
  1449.  
  1450.       The Developer Relations department at Novell Austin can provide
  1451.       information about Novell Database Products, technical support
  1452.       programs, and the Novell Professional Developers' Program.  You can
  1453.       request detailed product information from the automated fax system or
  1454.       speak to a trained technician about product announcements, pricing,
  1455.       compatibility, services, and developer issues.
  1456.  
  1457.  
  1458.       CompuServe Forum
  1459.  
  1460.       You can find information about Novell Database Products under the
  1461.       NetWire section on CompuServe.  NetWire provides 24-hour-a-day
  1462.       electronic information services.  You can obtain the most recent
  1463.       online technical notes, problem reports and fixes, product news, and
  1464.       other helpful information.  You can also post technical questions and
  1465.       receive answers from our technical support staff.
  1466.  
  1467.       If you already have a CompuServe account, type GO NOVELL to access
  1468.       the NetWire section.  For information about subscribing to
  1469.       CompuServe, contact CompuServe, Inc. at 1-800-848-8199
  1470.       (or 1-614-457-0802 in Ohio or outside the U.S. and Canada).
  1471.  
  1472.  
  1473.       Contacting Novell
  1474.  
  1475.       Novell has established a comprehensive services strategy to support
  1476.       all network users and systems--small or large, domestic or
  1477.       international.  We welcome hearing from you.
  1478.  
  1479.       The mailing address for Novell Austin is as follows:
  1480.  
  1481.                         Novell, Inc.
  1482.                         5918 W. Courtyard Drive
  1483.                         Austin, Texas 78730-5036
  1484.                                         U.S.A.
  1485.  
  1486.       To contact us by telephone or fax, refer to the following table for
  1487.       the appropriate number.
  1488.  
  1489.    For                 Contact            Telephone          Fax
  1490.    ------------------------------------------------------------------------
  1491.  
  1492.    Technical Support   Novell Services    1-800-NETWARE      1-512-794-1775
  1493.    International                          (1-800-638-9273)
  1494.     Technical Support                     or 1-801-429-5588
  1495.                                           outside the U.S.
  1496.  
  1497.    Product             Novell Austin      1-800-RED-WORD     1-512-345-7478
  1498.     Information*       Developer          (1-800-733-9673)
  1499.                         Relations         or 1-512-794-1796
  1500.                                           outside the U.S.
  1501.  
  1502.    General Inquiries   Novell Austin      1-512-346-8380     1-512-345-7478
  1503.                         Receptionist
  1504.  
  1505.    * International customers can contact their local reseller for Novell
  1506.      Database Products information.
  1507.  
  1508.    -  Page 1-13:  Add the following note before the last paragraph of the
  1509.       section "Using Xtrieve PLUS with Btrieve and XQLP."
  1510.  
  1511.       Note: The null file handles that are created when Xtrieve PLUS
  1512.             automatically loads Btrieve and XQLP are not released when you
  1513.             quit Xtrieve PLUS.  Depending on how high you set the FILES
  1514.             variable in your CONFIG.SYS file, there may not be any DOS file
  1515.             handles available when you attempt to start another
  1516.             application.  If this condition occurs, you must restart your
  1517.             computer before you can run another application.
  1518.  
  1519.    -  Page 1-16:  Add the following parameter.
  1520.  
  1521.       /r<y|n>   Tells Xtrieve PLUS whether to restore the original VGA
  1522.                 state after the VGA state is changed temporarily.
  1523.  
  1524.                 Some VGA video adapters cause unexpected results when
  1525.                 Xtrieve PLUS attempts to restore the VGA state after it has
  1526.                 been changed.  The /rn option tells Xtrieve PLUS not to
  1527.                 restore the original VGA state after the state has been
  1528.                 changed.  The /ry option (the default) tells Xtrieve PLUS
  1529.                 to restore the original VGA state.
  1530.  
  1531.    -  Page 1-17:  The description of the /w option should read as follows.
  1532.  
  1533.       Specifies the maximum view width (in bytes) that Xtrieve PLUS allows.
  1534.       The view width is determined by combining the length of each field
  1535.       in the view.  However, if a field's heading is longer than the field
  1536.       itself, use the length of the heading in your calculation.  You can
  1537.       specify from 4 to 8,192 bytes.  For example, the following parameter
  1538.       specification allows a view width of up to 256 bytes: /w:256.
  1539.  
  1540.       If you do not specify this option, Xtrieve PLUS uses a default value of
  1541.       1,024 bytes.  The larger the view width you specify, the fewer records
  1542.       Xtrieve PLUS can display on the screen at one time.
  1543.  
  1544.    -  Page 1-18:  Add the following note after the first paragraph of the
  1545.       section "Using the /k Option to Read a Keyboard Input File."
  1546.  
  1547.       Note: If the keyboard input file includes a directory path, use a
  1548.             double backslash to represent a single backslash.  For example,
  1549.             the path \XTRIEVE\DEMODATA would be represented as
  1550.             \\XTRIEVE\\DEMODATA in the input file.
  1551.  
  1552.    -  Page 1-19:  The first paragraph in the section "Using the MAIN Menu"
  1553.       should read as follows.
  1554.  
  1555.       After you start Xtrieve PLUS, the MAIN menu appears on your screen,
  1556.       as shown in Figure 1.4.  If you are using a mouse, a small block
  1557.       appears in the upper left corner of the screen.  This block indicates
  1558.       the mouse is enabled.  Also, the mouse cursor appears in the center
  1559.       of the screen (not shown in Figure 1.4).
  1560.  
  1561.    -  Page 2-38:  The section "Printing Wide Views" should read as follows.
  1562.  
  1563.       Printing Wide Views
  1564.  
  1565.       If your view is wider than 80 characters, you cannot print all of it
  1566.       at one time (unless your printer can handle more than 80 characters
  1567.       per line).  You must perform multiple print operations to print the
  1568.       view.  That is, print the first 80 characters, and then define a new
  1569.       offset value from the PRINT OPTIONS menu to print subsequent
  1570.       characters (in groups of 80 characters per print operation).
  1571.  
  1572.       To print a wide view, proceed as follows:
  1573.  
  1574.       1. For the first print operation, choose Print from the VIEW menu,
  1575.          select Yes from the DEFAULTS menu, and enter the device name in
  1576.          the DEVICE NAME box to send the view to the printer.
  1577.  
  1578.       2. For the second print operation, choose Print from the VIEW menu.
  1579.  
  1580.       3. When the DEFAULTS menu appears, select No.
  1581.  
  1582.       4. When the PRINT OPTIONS menu appears, accept the defaults until you
  1583.          get to the Offset option.  Enter 80 for the offset.
  1584.  
  1585.       If additional print operations are necessary, repeat Steps 2 through
  1586.       4, adding 80 to the offset each time until the entire view is
  1587.       printed.
  1588.  
  1589.    -  Page 3-15:  In Table 3-1, the description of a Null join should read
  1590.       as follows:
  1591.  
  1592.       Include all records from the primary file even if they have no
  1593.       matching records with the secondary file.
  1594.  
  1595.    -  Page 3-19:  Add the following note to the end of the section
  1596.       "Translating to an External Format."
  1597.  
  1598.       Note: If you use the Translate to DIF option to import dates into
  1599.             Lotus 1-2-3 from a file created by Xtrieve PLUS v4.10 or v4.11,
  1600.             the dates will be wrong by one day.  This is because Xtrieve
  1601.             PLUS uses the date 01/01/1900 as day 0, whereas Lotus considers
  1602.             the same date as day 1.  To convert the data to the proper
  1603.             date, use a formula in your Lotus spreadsheet to subtract one
  1604.             from the date.
  1605.  
  1606.    -  Page 4-6:  Add the following note at the end of the section "Absolute
  1607.       and Relative Positioning."
  1608.  
  1609.       Note: If the position of the first report item on a page (not
  1610.             including the heading) is set using absolute line positioning
  1611.             or using a relative line position of +0, Xtrieve PLUS places
  1612.             each occurrence of that report item on a new form, even if the
  1613.             NEW FORM option is set to No.
  1614.  
  1615.    -  Page 4-13:  In the last paragraph of the section "The Report Layout
  1616.       Screen," the sentence that begins "If you press Shift+F8" should read
  1617.       as follows.
  1618.  
  1619.       If you press Shift+F8 while the Report Layout screen is displayed in
  1620.       Prompt mode, you can see the line type for each line (header, detail,
  1621.       footer) in the left margin, as Figure 4.6 shows.
  1622.  
  1623.    -  Page 5-4:   Add the following note before the third bullet.
  1624.  
  1625.       Note: You cannot assign a mask to a date that prints as a result of
  1626.             the @date text directive; the date prints using the default
  1627.             date mask (mm/dd/yy).  If you want to apply a mask to the date
  1628.             in your report, add a user-defined date field to the view on
  1629.             which your report is based, and specify CURRENT as the field's
  1630.             definition.  This field will always contain the current date.
  1631.             When you position the field in the report, Xtrieve PLUS asks
  1632.             you to specify a mask.
  1633.  
  1634.    -  Page 7-24:  Add the following note after the first paragraph of the
  1635.       section "Defining Supplemental Indexes."
  1636.  
  1637.       Note: You cannot define or remove a supplemental index for a file
  1638.             that is active in a view.  Release the file before attempting
  1639.             either operation.
  1640.  
  1641.    -  Page 7-24:  Step 2 in the section "Defining Supplemental Indexes"
  1642.       should read as follows.
  1643.  
  1644.       2. Select the file for which you want to define a supplemental index.
  1645.          The menu that appears lists three options: Show, Define, and
  1646.          Remove.  (If you select a file that is currently active, the only
  1647.          option available is Show.)
  1648.  
  1649.    -  Page 7-25:  The first paragraph in the section "Removing Supplemental
  1650.       Indexes" should read as follows.
  1651.  
  1652.       To remove a supplemental index for a file, complete the following
  1653.       steps.  (Remember, you cannot remove a supplemental index for a file
  1654.       that is active in a view.)
  1655.  
  1656.    -  Page 7-25:  Step 2 in the section "Removing Supplemental Indexes"
  1657.       should read as follows.
  1658.  
  1659.       2. Select the file for which you want to remove a supplemental index.
  1660.          The menu that appears lists three options: Show, Define, and
  1661.          Remove.  (If you select a file that is currently active, the only
  1662.          option available is Show.)
  1663.  
  1664.    -  Page 10-5:  Replace the first sentence after Table 10.1 with the
  1665.       following.
  1666.  
  1667.       Xtrieve PLUS supports landscape printing.  Refer to the section
  1668.       "Defining Printer Devices" on page 10-7 for information about
  1669.       creating a device that allows you to print in landscape mode.
  1670.  
  1671.    -  Page 10-8:   Add the following note after Step 6.
  1672.  
  1673.       Note: Some printer manufacturers list a separate printer type for
  1674.             landscape printing.  For those printer types, the printer
  1675.             database displays (LS) as part of the type name.  Ensure that
  1676.             you choose the landscape printer type, where appropriate.
  1677.  
  1678.    -  Page 10-8:   Add the following note after Step 8.
  1679.  
  1680.       Note: If you are defining a device that allows you to print in
  1681.             landscape mode, modify the settings under Paper Setup as
  1682.             follows:
  1683.  
  1684.             Paper Length:  8.50 in
  1685.             Paper Width:  11.00 in
  1686.  
  1687.             Under Defaults, set the top and bottom margins to a minimum
  1688.             of .10 inches, and set the left and right margins to a minimum
  1689.             of .25 inches.
  1690.  
  1691.    -  Page 10-25:  Replace the description of the Display Width parameter
  1692.       in Table 10.4 with the following.
  1693.  
  1694.       Defines the maximum record width used in a view.  The default is
  1695.       1,024.  The maximum allowed is 8,192.
  1696.  
  1697.    -  Page 11-19:  The last paragraph in the section "Setting Environment
  1698.       Variables Using the Set Command" should read as follows.
  1699.  
  1700.       Replace variable with one of the 11 Xtrieve PLUS environment
  1701.       variables.  Do not insert a space on either side of the equal sign
  1702.       (=).
  1703.  
  1704.       If you want to negate a previous setting, issue the SET command
  1705.       as follows, replacing variable with one of the 11 Xtrieve PLUS
  1706.       environment variables, but without specifying a value.
  1707.  
  1708.          SET variable =
  1709.  
  1710.       The following sections explain how to set each of the Xtrieve PLUS
  1711.       environment variables with the SET command.
  1712.  
  1713.    -  Page 11-22:  Replace the section XTRPATH with the following.
  1714.  
  1715.       XTRPATH
  1716.  
  1717.       Xtrieve PLUS searches for your data files in the location specified
  1718.       in the dictionary, or in the location specified in the dictionary and
  1719.       the XTRPATH environment variable.  Xtrieve PLUS ignores the XTRPATH
  1720.       variable if the location specified in the dictionary begins with a
  1721.       backslash (\) or a drive letter, thus enabling you to use the
  1722.       dictionary alone to specify the complete path to search for the data
  1723.       files.  However, if you need to accommodate different location names
  1724.       based on users' drive mappings, you should use the XTRPATH
  1725.       environment variable in conjunction with the dictionary to specify
  1726.       the data file location.
  1727.  
  1728.       If you use the XTRPATH variable, ensure that the file location
  1729.       specified in the dictionary is complementary to the path specified in
  1730.       XTRPATH.  Depending on where you run Xtrieve PLUS, the XTRPATH
  1731.       variable can be used in a number of ways, as follows:
  1732.  
  1733.                       Data File Location
  1734.       XTRPATH         Specified in Dictionary     Comment
  1735.       -----------------------------------------------------------------
  1736.       F:\TEST\DATA    MYFILE.BTR                  Works in all cases
  1737.  
  1738.       \TEST\DATA      MYFILE.BTR                  Works if running
  1739.                                                   Xtrieve PLUS from F:
  1740.  
  1741.       TEST\DATA       MYFILE.BTR                  Works if running
  1742.                                                   Xtrieve PLUS from F:\
  1743.  
  1744.       To avoid binding users to a particular drive mapping and directory
  1745.       for their data file location, you should use XTRPATH to specify the
  1746.       drive and as much of the path as possible, specifying only the
  1747.       filename in the dictionary.  In the preceding example, if the file
  1748.       MYFILE.BTR resides on F:\TEST\DATA, you should set XTRPATH to
  1749.       F:\TEST\DATA and specify MYFILE.BTR as the data file location in the
  1750.       dictionary.
  1751.  
  1752.       However, in some cases, you may want to specify only part of the path
  1753.       in XTRPATH.  If you intend to store data files in several
  1754.       subdirectories with the same name but with different paths, specify
  1755.       the variable portion of the path in XTRPATH; use the dictionary to
  1756.       specify the subdirectory where the data files reside.
  1757.  
  1758.       You can also use the XTRPATH variable to instruct Xtrieve PLUS to
  1759.       search multiple directories for data files.  Use a semicolon to
  1760.       separate the directories.  For example, to instruct Xtrieve PLUS to
  1761.       search the directories F:\DATA and G:\FILES for data files, set
  1762.       XTRPATH as follows:
  1763.  
  1764.          SET XTRPATH = F:\DATA;G:\FILES
  1765.  
  1766.       If you modify XTRPATH from within Xtrieve PLUS and then save the
  1767.       configuration, Xtrieve PLUS stores the modified value with the
  1768.       configuration file.  However, the value stored in the operating
  1769.       system environment takes precedence over the value stored in the
  1770.       configuration file.
  1771.  
  1772.    -  Page A-1:  Replace the note in the section "Xtrieve PLUS Error
  1773.       Messages" with the following.
  1774.  
  1775.       Note: If the Xtrieve PLUS message file is not available, Xtrieve PLUS
  1776.             displays the following message:
  1777.  
  1778.                Xtrieve message file not loaded.  Error code = xxxx
  1779.  
  1780.             In this message, xxxx represents an internal code.  If you
  1781.             receive this message and you want Xtrieve PLUS to display
  1782.             textual error messages, you can either place the message file
  1783.             (XTRIEVE.MSG) in the directory from which you started Xtrieve
  1784.             PLUS or set the XTRMSG environment variable to indicate the
  1785.             directory that contains the Xtrieve PLUS message file.  (For
  1786.             more information on the XTRMSG environment variable, see
  1787.             Chapter 11, "Configuring Xtrieve PLUS.") You must restart
  1788.             Xtrieve PLUS for either of these changes to take effect.
  1789.             Thereafter, when an error condition occurs, Xtrieve PLUS
  1790.             displays one of the textual error messages described in this
  1791.             appendix.
  1792.  
  1793.    -  Page A-4:  Add the following message and description.
  1794.  
  1795.       Dictionary is Empty
  1796.  
  1797.       Xtrieve PLUS cannot access the dictionary files, or no dictionary
  1798.       files exist.  Either modify the configuration to specify the
  1799.       location of the dictionary files, or create dictionary files in the
  1800.       directory where Xtrieve PLUS is configured to find them.
  1801.  
  1802.    -  Page A-7:  Add the following message and description.
  1803.  
  1804.       Error Setting Field Attribute, Status = n
  1805.  
  1806.       In Xtrieve PLUS, Status Code n was returned when you set a field
  1807.       attribute.
  1808.  
  1809.    -  Page A-8:  Add the following message and description.
  1810.  
  1811.       File Does Not Have Any Fields which May Be Used in an Index
  1812.  
  1813.       In Xtrieve PLUS, you have attempted to define an index in a file in
  1814.       which all of the fields are of the data type bit.  A bit type field
  1815.       cannot be used as an index.  Either define a field of a data type
  1816.       other than bit and then use it in an index, or make the file a
  1817.       data-only file.
  1818.  
  1819.    -  Page A-10:  Add the following message and description.
  1820.  
  1821.       Insufficient Memory in Xtrieve to Show All Fields
  1822.  
  1823.       Xtrieve PLUS returns this message when there is not enough memory
  1824.       available to hold the field definitions you have specified.  To make
  1825.       more memory available, unload any TSRs that are not in use.
  1826.       Alternatively, if your workstation has expanded or extended memory,
  1827.       you can use your memory management program to move TSRs or
  1828.       applications to high memory.
  1829.  
  1830.    -  Page A-10:  Add the following message and description.
  1831.  
  1832.       Invalid Temporary Storage Directory.  Directory Must Exist
  1833.  
  1834.       Xtrieve PLUS used the directory specified in the XTRTMP environment
  1835.       variable to store temporary files that hold session-specific
  1836.       information.  Either create the directory you specified, or reset the
  1837.       XTRTMP variable to an existing directory.
  1838.  
  1839.    -  Page A-11:  The message "Missing or invalid 'col' specification in
  1840.       text window file" should read "Missing or Invalid '@xxxxx'
  1841.       Specification in Text Window File."  The explanation of this message
  1842.       should read as follows.
  1843.  
  1844.       In Xtrieve PLUS, the specification for the column location, row
  1845.       location, or width value in the text window file is either invalid or
  1846.       missing.  Correct the value, or supply it if it is missing.
  1847.  
  1848.    -  Page A-12:  The message "Missing or Unrecognized Menu Definition
  1849.       File" should read "Missing or Invalid Menu Definition File."  The
  1850.       explanation of this message should read as follows.
  1851.  
  1852.       Either Xtrieve PLUS attempted to use an old version of the menu
  1853.       definition file (XTRIEVE.MEN), or it cannot find the menu definition
  1854.       file.  Ensure that you are using the version of the menu definition
  1855.       file contained on your Xtrieve PLUS diskettes.  Also, this file must
  1856.       be located in either the current directory or the directory specified
  1857.       in the configuration file (using the XTRMEN environment variable) as
  1858.       the location for the menu definition file.
  1859.  
  1860.    -  Page A-12:  Add the following message and description.
  1861.  
  1862.       Money Fields May be from 2 to 10 Bytes Inclusive
  1863.  
  1864.       In Xtrieve PLUS, you defined a money type field with a size less than
  1865.       2 or greater than 10.  Modify the size of the field so that it is
  1866.       within the valid range.
  1867.  
  1868.    -  Page A-15:  Add the following message and description.
  1869.  
  1870.       Numeric Fields May be from 1 to 15 Bytes, Inclusive
  1871.  
  1872.       In Xtrieve PLUS, you defined a numeric type field with a size less
  1873.       than 1 or greater than 15.  Modify the size of the field so that it
  1874.       is within the valid range.
  1875.  
  1876.    -  Page A-15:  Add the following message and description.
  1877.  
  1878.       Out of File Handles.  Increase 'FILES=' Parameter in CONFIG.SYS
  1879.  
  1880.       Xtrieve PLUS cannot assign a DOS handle to open the file.  Increase
  1881.       the 'FILES=' parameter in the CONFIG.SYS file.
  1882.  
  1883.    -  Page A-17:  Add the following message and description.
  1884.  
  1885.       Please Specify an Integer Value Between 0 and 10, Inclusive
  1886.  
  1887.       The value specified for the Delay Time option on the
  1888.       CONFIGURE/PARAMETERS menu tells Xtrieve PLUS how many tenths of a
  1889.       second to delay when replaying command files.  This value must be
  1890.       an integer between 0 and 10, inclusive.
  1891.  
  1892.    -  Page A-17:  Add the following message and description.
  1893.  
  1894.       Please Specify an Integer Value Between 4 and 8192, Inclusive
  1895.  
  1896.       In Xtrieve PLUS, the value specified for the Display Width option on
  1897.       the CONFIGURE/PARAMETERS menu defines the maximum record width used
  1898.       in a view.  This value must be an integer between 4 and 8,192,
  1899.       inclusive.
  1900.  
  1901.    -  Page A-17:  Add the following message and description.
  1902.  
  1903.       Please Specify an Integer Value Greater than 0
  1904.  
  1905.       In Xtrieve PLUS, the values specified for the Views, Fields, and
  1906.       Report Items options on the CONFIGURE/PARAMETERS menu define the
  1907.       maximum number of active views, the maximum number of active fields
  1908.       in all views, and the maximum number of report elements in a report,
  1909.       respectively.  For these options, you must specify an integer value
  1910.       greater than 0.
  1911.  
  1912.    -  Page A-20:  Add the following message and description.
  1913.  
  1914.       The User PUBLIC Cannot Be Removed
  1915.  
  1916.       In Xtrieve PLUS, you attempted to remove the user PUBLIC by using the
  1917.       Security option.  Since the user PUBLIC is system defined, you cannot
  1918.       remove it.
  1919.  
  1920.    -  Page A-22:  Add the following message and description.
  1921.  
  1922.       Unable to Drop File Definition, Status = n
  1923.  
  1924.       In Xtrieve PLUS, you do not have ownership of the file.  Determine
  1925.       the Btrieve owner name and try the operation again.
  1926.  
  1927.    -  Page A-22:  Add the following message and description.
  1928.  
  1929.       Unable to Drop Supplemental Index, Status = n
  1930.  
  1931.       In Xtrieve PLUS, you do not have ownership of the file for which the
  1932.       index is defined.  Determine the Btrieve owner name and try the
  1933.       operation again.
  1934.  
  1935.    -  Page A-22:  Add the following message and description.
  1936.  
  1937.       Unable to Open Keyboard Input File
  1938.  
  1939.       If you entered /k:filename on the command line, Xtrieve PLUS is
  1940.       unable to find the specified keyboard input file.  If you are using
  1941.       the XTRIEVE.CNF file to implement the /k option, ensure that
  1942.       XTRIEVE.CNF is not corrupted.
  1943.  
  1944.    -  Page A-24:  Add the following message and description.
  1945.  
  1946.       User Defined Field Cannot Be Added When There Is a Variable-Length
  1947.       Field
  1948.  
  1949.       When you are creating a view that includes a variable-length field in
  1950.       Xtrieve PLUS, the variable-length field must be the last field you
  1951.       define.  Remove the variable-length field, add the user-defined
  1952.       field, and redefine the variable-length field.
  1953.  
  1954.    -  Page A-24:  Add the following message and description.
  1955.  
  1956.       User Input Is Required, But No Input Source Is Available
  1957.  
  1958.       In Xtrieve PLUS, you attempted to run a command file that requires
  1959.       keyboard input, but no keyboard input file is available.  Restart
  1960.       Xtrieve PLUS without using the /d startup option.  Alternatively, you
  1961.       can restart it using the /k startup option and provide a keyboard
  1962.       input file.  (See "Running Xtrieve PLUS" in Chapter 1.)
  1963.  
  1964.    -  Page A-41:  Add the following Status Codes and descriptions.
  1965.  
  1966.       207       Field Does Not Exist in the Dictionary
  1967.  
  1968.                 One of the fields in the list is not defined in the
  1969.                 currently active dictionary.  Be sure you specified the
  1970.                 names correctly and you used the appropriate character
  1971.                 representation for a blank if the name contains embedded
  1972.                 blanks.
  1973.  
  1974.       208       The Position Parameter Value Is Out of Range for This
  1975.                 Function
  1976.  
  1977.                 The position you specified for a field in a field list is
  1978.                 out of range.  Valid positions are between 1 and the number
  1979.                 of fields in the view, inclusive.
  1980.  
  1981.    -  Page A-43:  Add the following Status Code and description.
  1982.  
  1983.       227       Operand Must Be a Dictionary Field
  1984.  
  1985.                 The first operand in a restriction statement must be a
  1986.                 valid field that is defined in the dictionary.
  1987.  
  1988.    -  Page A-49:  Add the following status codes.
  1989.  
  1990.       349  The Specified Data Value Is Too Large for the Field Definition
  1991.  
  1992.        The data value you specified is larger than the maximum length
  1993.        defined for the field.
  1994.  
  1995.       350  Security Has Not Been Enabled on This Dictionary
  1996.  
  1997.        You attempted an operation that you can do only when security is
  1998.        enabled.  Database security is not enabled at this time.  To perform
  1999.        the operation successfully, you must first enable security on that
  2000.        database.
  2001.  
  2002.       351  A Transaction Has Not Yet Been Started
  2003.  
  2004.        You attempted to perform a COMMIT or ROLLBACK operation without being
  2005.        inside a transaction.  You must start a transaction before you can
  2006.        perform a COMMIT or ROLLBACK operation.  To start a transaction,
  2007.        issue a START TRANSACTION operation.
  2008.  
  2009.       352  Record Count Must Be Greater Than Zero
  2010.  
  2011.        NetWare SQL received a record count value for the xFetch call that is
  2012.        not more than zero.    The record count for an xFetch call must be at
  2013.        least 1.
  2014.  
  2015.    -  Page D-5:  The description of Bit 5 of Xi$Flags should read as
  2016.       follows.
  2017.  
  2018.       Index is not case sensitive.
  2019.  
  2020.    -  Page E-1:  Add the following parameters.
  2021.  
  2022.       /r<y|n>   Tells Xtrieve PLUS whether to retain the current VGA state
  2023.                 when the VGA state is changed temporarily.
  2024.  
  2025.       /s        Identifies the NetWare SQL or XQLP session
  2026.  
  2027.    -  Page E-1:  Change the maximum value for the /f parameter from 511 to
  2028.       N/A; there is no maximum value for this parameter.
  2029.  
  2030.  
  2031.    Note the following changes to the "Xtrieve PLUS Tutorial":
  2032.  
  2033.    -  Page 3-21:  Step 2 of the section "Justifying Data in a View" should
  2034.       read as follows.
  2035.  
  2036.       If modifying a field, select the field you want from the MODIFY menu.
  2037.       If adding a field, select No from the DEFAULTS menu, and then select
  2038.       the field you want from the ADD menu.
  2039.  
  2040.    -  Page 4-15:  In the example given in Step 2 of the section "Browsing a
  2041.       View," reverse the values for Amt Paid and Balance Due.
  2042.  
  2043.    -  Page 4-18:  Step 9 of the section "Creating the Schedule View" should
  2044.       read as follows.
  2045.  
  2046.       9. Select the USER DEFINED option, and then select String from the
  2047.          TYPE menu.  Enter 35 for the field size.
  2048.  
  2049.  
  2050. ================================================================================
  2051. Online Help Updates
  2052. ===================
  2053.  
  2054.    -  Several sections of the help text indicate you can define a maximum
  2055.       of 119 indexes for a file.  Xtrieve PLUS allows only 24 indexes per
  2056.       file.
  2057.  
  2058.    -  The help text includes several references to the numericsts data
  2059.       type.  However, Xtrieve PLUS does not support this data type.
  2060.  
  2061.    -  In the section of the help text that discusses the Parameters option
  2062.       on the CONFIGURATION menu, the references to the NetWare SQL
  2063.       Requester and the NetWare Btrieve Requester should read XQLP and
  2064.       Btrieve, respectively.
  2065.  
  2066. ** End of XTRDOS.DOC **
  2067.